home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / disk / findx.zip / FINDER.DOC < prev    next >
Text File  |  1996-07-11  |  8KB  |  159 lines

  1.  
  2.                               F I N D E R  V1.6
  3.  
  4.                               by John Augustine
  5.  
  6.                Finder was written in Assembly for MS Dos Systems.
  7.  
  8.                    Now with DUAL AND/OR (Option) SEARCH!
  9.  
  10.   Requires Color Graphics (CGA) or better. Runs on 8086 to Pentium Computers.
  11. Needs little memory to operate.  See below for History of changes.
  12.  
  13.   Have you ever wanted to Find information in a Text file, but did not know
  14. which Text file has that information?  Of course there are many Text file
  15. programs that allow you to View and Search for a Pattern, but I have not
  16. found one that will do MULTIPLE files with one "Pass". You have to enter
  17. or Tag each File's Name in turn, to View or Search it's contents. FINDER
  18. eliminates this Hassle. You can have hundreds of files and automatically
  19. Search or View all of them.  Simply enter *.* for all files in Current
  20. Directory, or *.DOC for all .DOC files, etc.  Of course you can enter the
  21. complete File Name for just one file too.  Finder allows you to View or Search
  22. Multiple files easily.  Press Enter during a Pause, to Skip the Current
  23. File, and go to the next file, whether you are in Search Mode, or just Viewing
  24. files.  To View files, select View File/s at the Main Menu.  Select Search...
  25. at the Main Menu to Search File/s for Pattern/s.  In Search mode, Finder will
  26. pause if the pattern is found anywhere within the Screen Page. You can resume
  27. Search by pressing F1, or press Enter to go to the next file.  After a pause
  28. occurs (Pattern found) during a Search, you can browse using the Up, Down,
  29. Page Up or Page Down Keys, the highlighted patterns will remain highlighted so
  30. you don't loose track of their locations.  Press F1 at anytime to resume
  31. Search.
  32.  
  33.   IMPORTANT NOTE: When Searching several Files for a Pattern/s, and a pause
  34. does not occur (Pattern/s not Found or next Pattern/s not Found), if you press
  35. the ESC Key to Abort, it will take effect when the End of the Current File is
  36. reached.  This is one of the V1.6 improvements.  Older versions, Abort only
  37. took effect if a Pattern is Found.
  38.  
  39.    Introducing DUAL (OPTION) AND/OR SEARCH Feature, added in V1.4
  40.  
  41.    I have been using Finder a great deal.  A Major Hassle still exists.  If
  42. the Pattern you are Searching for, is common under different categories.  I
  43. guess the best way to explain it is to give you some of my own experiences.
  44.  
  45. 1.  I was Searching through a group Files, with listings of Files from
  46. different BBSs, for Source codes on Sound Blaster Utilities.  I entered "Sound
  47. Blaster" (without quotes) for the Search Pattern.  Do you know how much Sound
  48. Blaster "stuff" there is?  Most of it did not include Source Code.  On the
  49. other hand, entering "Source" was no better, since "Source" has other
  50. categories too.
  51.  
  52. 2.  Another time, I wanted to see if there was an E-Mail Directory among all
  53. those listings of BBS Files.  Now, if there was "E-Mail Directory" in the
  54. description, that would not be a problem, but "Directory of E-Mail addresses"
  55. or many other possible variations, make it difficult.  Do you know how many
  56. times I found something with "E-Mail" in it?  On the other hand, entering
  57. "Directory" was much worse.  I had many experiences like this with other
  58. Searches.
  59.  
  60.    V1.4 to the rescue, HALLELUJAH!!!!  The "AND" is the Best part of this
  61. version.  Now I simply enter, "Directory" (without Quotes) for one Pattern,
  62. and "E-Mail" for the Second Pattern.  Note: The order does NOT matter.  If I
  63. enter "E-Mail" first and "Directory" second, the results are the same.  When
  64. both Patterns are within two (line before or line after) regular lines of each
  65. other, Finder will pause.  Both Patterns could be in the same line too.  If
  66. the Document you are searching doesn't end each "line" with a CR (Carriage
  67. Return) but uses CRs to end paragraphs, then the two patterns Must be in the
  68. same paragraph, before Finder Pauses during the Search (I call it "Long Line"
  69. Text because of the effect it has in many Text editors).
  70.  
  71.   NOTE:  Once in awhile, it is possible during the "AND" Search mode, that a
  72. Pause will occur with only one of the two Patterns showing (in the Last line
  73. of the screen Page).  Simply use the Down Key to move up the Text to reveal
  74. the other Pattern in the next line.
  75.  
  76.   The "OR" search mode simply means that Finder will Pause at every occurrence
  77. of one Pattern OR the other.
  78.  
  79.   Of course you can use Finder to search for a single Pattern too.
  80.  
  81.   Getting Started:
  82.  
  83.     Type FINDER and press Enter, or
  84.  
  85.     Type FINDER *.DOC and press Enter (*.DOC is Example) Sets a Default File
  86. Name.
  87.  
  88.  
  89.   HISTORY OF CHANGES:
  90.  
  91.  
  92.   V1.3 CHANGES:
  93.  
  94.   Although I have used FINDER many times without a problem, I overlooked the
  95. possibility that there may be non-Text files in the Directory, if you use the
  96. *.* (All Files) in Current Directory for a Search.  V1.2 assumes that "All
  97. Files" will be Text files.  I have a Directory with all my Text Files, but
  98. overlooked the possibility that others may not.  After modifying FINDER, I
  99. tested it in a Directory with all types of files, using the All Files (*.*)
  100. for the File Name.  This version (V1.3) did not Crash in Search Mode, but
  101. version 1.2 did.  While I was at it, I also increased the size of the Line
  102. Buffer from 4000 to 10,000 characters. This Line Buffer is for "Long Line"
  103. Text.  There are documents that don't end each "line" with a Carriage
  104. Return, but only use them at the end of Paragraphs.  In many Text Editors,
  105. those documents appear to have a "Long Line".
  106.  
  107.   V1.4 CHANGES:
  108.  
  109.   Optional Dual AND/OR Search modes added.  Also, I discovered a glitch in
  110. V1.3.  Sometimes, if the Search Pattern was in the last screen "Page" of the
  111. file, Finder did not always pause, but moved on to the next file.  I fixed
  112. that in V1.4.
  113.  
  114.   V1.5 ADJUSTMENT:
  115.  
  116.   The "AND_FLG" Variable was in the wrong part of the variables in V1.4.  I
  117. found out shortly after I Uploaded it.  In spite of all the testing I did (you
  118. can never do too much testing).  I never once did a single Pattern Search
  119. right after an "AND" Search.  The "AND_FLG", which I thought was in the Clear
  120. Variables area, was not cleared when the "AND" Search was finished.
  121. Afterwards, a single Pattern Search could not find anything.  Being Human, we
  122. are all imperfect.
  123.  
  124.   V1.6 IMPROVEMENTS:
  125.  
  126.   I changed the Main Menu and made View File/s a separate selection.  This
  127. may be less confusing.
  128.   I also discovered an Odd Bug recently.  Moving (using Page Up or Up Key) to
  129. the beginning of a File, after a pause occurred (Pattern found) in Search
  130. Mode, and Pressing F1 Key to Resume Search (from the beginning) caused the End
  131. of that File.  That's FIXED now.
  132.   Another improvement involves Aborting while Searching many files for a
  133. Pattern.  Before, if you pressed the ESC Key, it took effect if a Pattern is
  134. found.  Otherwise, you had to wait until all the Files have been Read
  135. (Searched).  For those of you who have older Computers, that could be a real
  136. problem (time).  Now, all you have to do is Press the ESC Key (you don't have
  137. to hold it down), when the End of the Current File is reached, the Abort takes
  138. effect (unless a Pattern is found before the End of the Current File is
  139. reached).
  140.   The "Lines" number display is improved.  Now, it won't "roll over" to 0
  141. after reaching 65,535, but can continue up to near 700,000,000!
  142.   Some Cosmetic changes in the View Screen have been made too.
  143.   The Path change option allows the user to select A to Z drive.  Finder (via
  144. Dos) now checks to see if the Selected Drive is present.
  145.  
  146.   Any comments, complaints, or SUGGESTIONS are ALWAYS welcomed.  Any questions,
  147. please include a Self Addressed Stamped Envelope.  A small donation is not
  148. expected, but will be GREATLY APPRECIATED.  If you have a question, don't feel
  149. obligated to make a donation.  I made this program because I needed it.
  150.  
  151.  
  152.   My address:
  153.  
  154.                             John Augustine N3AOF
  155.                             3129 Earl St.
  156.                             Laureldale, Pa 19605
  157.                             (610) 929-8850
  158.  
  159.